STAGE NRYCO - AGENTE DO POWERPOINT PARA MAC - v1.6  (06/10/2026)
============================================================

O QUE E
  O agente e o programinha que fica na MAQUINA DOS SLIDES e conta ao STAGE em
  que slide voce esta - e recebe do STAGE os comandos de passar slide.
  Esta e a versao para Mac, e ela fala com o POWERPOINT E COM O KEYNOTE.

  E UM AGENTE SO. Nao ha um programa para cada: ele olha os dois e usa o que
  esta com a apresentacao na mao. Se os dois estiverem abertos, quem estiver
  APRESENTANDO ganha; se nenhum estiver, quem tiver arquivo aberto.

  Ele nao substitui o STAGE: o STAGE continua na mesa do operador. O agente
  vai no computador que roda os slides.

COMO INSTALAR
  1. De dois cliques em "STAGE NRYCO Agente PPT para Mac.tar.gz" - o Mac
     descompacta e aparece "STAGE NRYCO Agente.app".
  2. Arraste para a pasta Aplicativos.
  3. NA PRIMEIRA VEZ: botao direito no app > Abrir > Abrir.
     (O app nao e assinado pela Apple; o Mac avisa uma vez e depois abre.)
     Se aparecer "esta danificado", abra o Terminal e cole:
       xattr -dr com.apple.quarantine "/Applications/STAGE NRYCO Agente.app"

  4. NA PRIMEIRA VEZ TAMBEM: o Mac vai perguntar se o agente pode controlar o
     "Microsoft PowerPoint" e/ou o "Keynote". RESPONDA PERMITIR.
     O Mac pergunta SEPARADO para cada programa, e so na primeira vez que o
     agente fala com cada um - entao se voce usa os dois, vao aparecer duas
     perguntas, em momentos diferentes. Sem permitir, ele nao le o slide.
     Se responder Nao sem querer: Ajustes do Sistema > Privacidade e
     Seguranca > Automacao > STAGE NRYCO Agente > ligar PowerPoint e Keynote.

     SO PARA O KEYNOTE: tela preta e tela branca sao a tecla B e W, e para
     mandar tecla o Mac exige uma permissao a mais - Privacidade e Seguranca >
     Acessibilidade > ligar o STAGE NRYCO Agente. Sem ela, todo o resto
     funciona; so esses dois botoes nao.

COMO USAR NO EVENTO
  1. Abra a apresentacao no PowerPoint OU no Keynote.
  2. Abra o "STAGE NRYCO Agente". Uma janela de Terminal mostra:

       Endereco para por no STAGE:  192.168.0.42:8787

  3. No STAGE (na outra maquina), aba Monitor, ponha esse endereco.
  4. Pronto: o STAGE passa a mostrar o slide atual, e os botoes de passar
     slide do STAGE comandam a apresentacao desta maquina.

  Deixe a janela do Terminal ABERTA durante o evento. Fechou, o agente para.

O QUE ESTA VERSAO FAZ
  - fala com o PowerPoint E com o Keynote, escolhendo sozinho;
  - diz o slide atual, o total e o nome do arquivo;
  - obedece: proximo, anterior, primeiro, ultimo, ir para o slide N, tela
    preta, tela branca, voltar da tela preta, encerrar e iniciar a
    apresentacao.

O QUE ELA AINDA NAO FAZ (e o do Windows faz)
  - contar slides ocultos;
  - acompanhar video dentro do slide (nome, tempo que falta).
  Esses dois dependem de uma leitura mais funda da apresentacao e ainda nao
  foram testados num Mac de verdade. Preferimos nao prometer.

  SO NO KEYNOTE, uma diferenca a mais: o agente manda a tela ficar preta ou
  branca, mas nao consegue LER se ela esta - o Keynote nao conta isso a
  ninguem. Entao o STAGE mostra "tela normal" mesmo com a tela preta. No
  PowerPoint ele sabe.

SE NAO FUNCIONAR
  - "porta 8787 ocupada": outro programa esta usando. Feche e abra de novo.
  - O STAGE nao acha o agente: confira se os dois estao na MESMA REDE e se o
    endereco digitado e o que aparece na janela do agente.
  - A janela abre e fecha na hora: o Mac bloqueou o app. Faca o passo 3.

  Duvidas: diego@nrycotecnica.org
